home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 7: Sunsite / Linux Cubed Series 7 - Sunsite Vol 1.iso / system / network / admin / hnms.txt < prev    next >
Text File  |  1996-11-17  |  8KB  |  184 lines
  1. A free package called HNMS, the NAS Hierarchical Network Management
  2. System, is now available.  The software may be ftp'd from ftp.netcom.com
  3. in the directory pub/heyjude.  (We're looking for other sites
  4. to pick this up, as netcom is pretty bogged down -- offers are welcome).
  5.  
  6. ----------------------------------------------------------------------------
  7.  
  8.                 HNMS v2.0g2
  9.  
  10.     This is the first public release of HNMS, the NAS Hierarchical
  11.     Network Management System.  HNMS may be used to monitor status
  12.     and generate traffic statistics for a large, routed IP network.
  13.  
  14.     Graphical displays are provided for the X11 Window System and
  15.     make use of the Motif widget set.  HNMS is unique is that it
  16.     can be used to graphically display routing information.  The
  17.     GUI provides compact representations of LANs, in which the status
  18.     of every subnet, host, and IP address can be displayed in a small
  19.     area.  Netmask misconfigurations can be picked out immediately.
  20.     It also correctly displays various WAN architectures, such as
  21.     those which include multiple IP addresses per interface
  22.     (or vice versa), or subnets which spread across multiple links.
  23.     A custom version of HNMS was used to generate the live,
  24.     three-dimensional representation of the cross-country ATM network
  25.     at Supercomputing '93 in Portland, Oregon.
  26.  
  27.     Data collection is handled via SNMP, ICMP, and direct layer 2
  28.     monitoring.  Distribution of network management information is
  29.     done via HNMP, a new protocol which builds upon the simple,
  30.     stateless client-server model used by SNMP.  HNMP defines
  31.     network objects, binds SNMP variables to them, and facilitates
  32.     higher level management operations on them.  The ASN.1
  33.     specification of HNMP is included in this package.
  34.  
  35.     Please note that there is also a release of HNMS that we are
  36.     distributing through COSMIC, NASA's software technology
  37.     transfer organization.  COSMIC may (or may not) provide
  38.     support for that distribution, but please do not ask them
  39.     for any kind of support concerning this one.  They will not
  40.     be able to help you.  This version of HNMS has been made
  41.     available to you, by special dispensation, as FREE SOFTWARE
  42.     under the GNU public licence ("copyleft").  It is distributed
  43.     as is, with NO WARRANTY for its fitness for any purpose.
  44.     If it is redistributed, you may not charge for it or any
  45.     derivative work.  Please see the file "COPYING" for details
  46.     about all this.
  47.  
  48.     Full source code is provided.  We encourage the Internet
  49.     community to experiment with, build upon, use, port, learn from,
  50.     add modules to, write scripts for, and expand this software
  51.     package.  There are some areas in which it can be improved,
  52.     especially in the areas of generality and efficiency.
  53.     We would like to see standardized displays for various types
  54.     of networks and monitored objects, as well as customized displays
  55.     for specific network hardware, and have them be freely available
  56.     to everyone.
  57.  
  58.     The authors do not have the resources to maintain this software
  59.     outside of NAS.  Although we may continue to add enhancements,
  60.     we are hoping that other(s) will take on the role of incorporating
  61.     bug fixes and extensions to the code, and sending out new releases.
  62.  
  63.     We do welcome any suggestions or bug reports that you may
  64.     have -- but there's no guarantee that we will be able to
  65.     help you, or even have time to respond.  We are working full
  66.     time (and then some) on other projects.  To reach us via
  67.     email, mail to hnmsdev@nas.nasa.gov.
  68.  
  69.     This software has not been extensively tested.  Neither the authors,
  70.     nor NASA, nor anybody at all takes any responsibility for any damage
  71.     that HNMS may cause, directly or indirectly, to your network, your
  72.     users, or anything.
  73.  
  74.     That said, it works pretty well for us.
  75.  
  76.     Jude George        Leslie Schlecht
  77.     jude@nas.nasa.gov    schlecht@nas.nasa.gov
  78.  
  79.     Any opinions expressed above are a figment of your imagination,
  80.     and should not be taken to reflect the views of NAS, NASA, CSC,
  81.     or anybody else.
  82.  
  83. ----------------------------------------------------------------------------
  84.     TO BUILD, follow the instructions in the top-level Makefile.
  85.  
  86. ------>    Be forewarned that you will need to obtain the Motif libraries,
  87. ------>    ISODE-7.0 (not 8.0) and tcpdump if they do not already exist
  88.     on your system.
  89.  
  90.     FOR COMPLETE INSTRUCTIONS on installing and using HNMS,
  91.     please read the file docs.ps.
  92.  
  93. ----------------------------------------------------------------------------
  94. Here are some quick-start instructions for the HNMS daemon, the graphical
  95. user interface, and the textual user interface.  The binaries are called
  96. hnmsd, hnms, and hnmstool.
  97.  
  98. INSTALLATION
  99.  
  100. 1. Untar and build the HNMS distribution.  Sources, docs, and auxiliary
  101.    files are included.  This version of HNMS has only been tested on
  102.    the Silicon Graphics Iris under IRIX 4.0.5.  It should work with little
  103.    modification on SparcStations running SunOS 4.x.
  104.  
  105. 1. Choose a directory to be the hnms "home", and copy the binaries
  106.    and the background/ directory to that directory.
  107.  
  108. 2. Set the $HNMS_HOME environment variable to be that directory.  You
  109.    may want to put this in your .login.
  110.  
  111. 3. Make sure tcpdump is in your path.  It's usually located in
  112.    /usr/local/etc.  The HNMS IO module uses tcpdump to discover new
  113.    IP addresses.
  114.  
  115. 4. Make the hnmsd (and tcpdump, if necessary) setuid root.  The HNMS
  116.    IO module, contained within hnmsd, needs root to access the ICMP
  117.    socket.
  118.  
  119. 5. Set the HNMS_PROMISCUOUS environment variable.  We are just using
  120.    this as a flag to tell the IO module that it's okay use promiscuous
  121.    Ethernet monitoring.
  122.  
  123. 6. Start hnmsd.
  124.  
  125. RUNTIME -- GUI
  126.  
  127. The GUI binary is called "hnms".  If you are running it on a machine
  128. different from the server, set the HNMS_SERVER environment variable
  129. to have the server machine's name.
  130.  
  131. Start the hnms program.  Once the GUI's main window appears, choose
  132. "Open" from the "HNMP" menu at the top center of the window.  A new
  133. window titled "Server" will pop up.  In this window, type "public"
  134. in the Community field, and the hostname of the server machine in the
  135. Selection field.  Then click the Connect button. 
  136.  
  137. At this point, you can start building diagrams.  Choose "New -->
  138. Custom Status View" from the HNMS menu on the main window.
  139. An "EDIT" window will pop up.  Type an asterisk in the Selection
  140. field, then click Add, then click the check mark at the top.
  141. You will see a display of all the hosts that the server currently
  142. knows about ("Processor" objects), along with their IP addresses
  143. ("Ipaddr" objects") and the subnets they are connected to ("Subnet
  144. objects).  If you have just recently started up hnmsd, the objects
  145. will appear magenta while hnmsd is ramping up.  This process
  146. takes three minutes.  Afterwards they will change to green.
  147. When a reachable object becomes unreachable, it changes to yellow,
  148. then red.
  149.  
  150. Feel free to experiment with the rest of the menu items.  "Site" and
  151. "WAN" diagrams may be built in a manner similar to the "Custom".
  152. For WAN diagrams to be displayed properly, the sysLocation field of
  153. your hosts should be in the format <any-string> <longitude> <latitude>.
  154. For example, "NASA Ames Research Center -122.5 37.1".
  155.  
  156. RUNTIME -- PLAINTEXT
  157.  
  158. You may also run hnmstool.  This program takes commands on stdin and
  159. outputs results on stdout, so it can be used effectively from within
  160. shell scripts.  For a demonstration, we will run it interactively.
  161.  
  162. The hnmstool does not give a prompt.  After starting it, wait a minute
  163. or two for it to get the list of HNMS objects from the server.
  164. for the HNMS daemon to pick up a good assortment of objects from the
  165. network.  Then type list.  You should see a list of objects scroll down
  166. the screen.  Only hosts with SNMP agents responding to "public" will be
  167. shown.  To pick up other hosts, type hint <hostname> <community-name>.
  168. For example:
  169.  
  170. hint snafu.nas.nasa.gov foobar
  171.  
  172. The next time you type list, you should see                     
  173.  
  174. processor:snafu
  175.  
  176. among the objects.  To get data about an object, type
  177. subscribe "<object>" <variable>@<interval>.  For example:
  178.  
  179. subscribe "processor:snafu" sysUpTime.0@15
  180.  
  181. This will give you a report of the value of the sysUpTime.0 variable
  182. every 15 seconds, if the variable changes.  Since sysUpTime.0 constantly
  183. changes, you will get an update on stdout every 15 seconds.
  184.